home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / program / jdif10.zip / JDIF.TXT < prev    next >
Text File  |  1996-05-04  |  3KB  |  107 lines
  1. jDif v1.0 - Fast File Difference Utility
  2.  
  3. (c) Jony Rosenne, 1994, 1996
  4. 100320.1303@CompuServe.com
  5.  
  6. jDif compares text files and shows the differences between them on a 
  7. line by line basis.
  8.  
  9. jDif assumes the first file is an old version of a file, and the 
  10. second file a new version of the file.
  11.  
  12. The files are compared as text, line by line. A line may end with the 
  13. DOS standard CR-LF, or just with a new line character ('\n').  
  14. Trailing blanks are ignored. Tabs are expanded assuming a tab 
  15. position every 8 characters.
  16.  
  17. jDif has special support for COBOL: With the /c option, jDif compares 
  18. columns 7 to 72 of each line, and ignores differences which are out 
  19. of these margins.
  20.  
  21. jDif has special support for System/370 Assembler code: With the /a 
  22. option, jDif compares columns 1 to 72 of each line, and ignores the 
  23. sequence numbers.
  24.  
  25. There are three output options: Visual, Report and DOS FC style.
  26.  
  27.  
  28. Visual
  29. ======
  30. The default output is visual: Common lines are displayed in white 
  31. over a blue background, lines that are present only in the old file 
  32. (the first) are red over black, and lines only in the new file (the 
  33. second) are green over black.
  34.  
  35. Navigation is easy and fast: the arrows (up, down, left and right) do 
  36. what you would expect them to do, n takes you to the next difference, 
  37. p takes you to the previous difference, Home takes you to the first 
  38. page, End takes you to the last page.
  39.  
  40. Control-Home takes you the first position in the first page, Control-
  41. Left and Control-Right shift the page half a page sideways.
  42.  
  43. F1 shows a summary of the keyboard functions.
  44.  
  45. F4 - a toggle - shows the line numbers. Common lines show the line 
  46. numbers they had in the "old" file.
  47.  
  48. To quit you may use Esc, F3 or Alt-F4.
  49.  
  50. Report
  51. ======
  52. If option /r is set, jDif sends to standard output a report on the 
  53. differences.  Each run of inserted or deleted lines is preceded by a 
  54. heading, such as:
  55.  
  56.       Delete lines 3-4:
  57.       Insert after line 4:
  58.  
  59. The output will be buffered (for speed) unless the /v option is set. 
  60. It may be redirected to a file.
  61.  
  62.  
  63. DOS FC style
  64. ============
  65. If option /f is set, jDif sends to standard output a report similar 
  66. to the output of the DOS program FC (File Compare).
  67.  
  68. The output will be buffered (for speed) unless the /v option is set. 
  69. It may be redirected to a file.
  70.  
  71.  
  72. Use
  73. ===
  74. To call jDif use the following DOS command:
  75.  
  76.       jdif oldfile newfile [options]
  77.  
  78. The options, which may come before or after the file names, are:
  79.       /c    COBOL (columns 7 to 72)
  80.       /f    DOS FC style output
  81.       /h    Help (this is it)
  82.       /r    output Report
  83.       /v    do not buffer the output
  84.  
  85.  
  86. The author
  87. ==========
  88. Jonathan (Jony) Rosenne
  89. e-mail: 100320.1303@CompuServe.com
  90. Mail:   P O Box 33641
  91.         Tel Aviv
  92.         Israel
  93.  
  94. Customized versions may be obtained to support unique requirements, 
  95. for example to ignore change signatures.
  96.  
  97. Acknowledgments
  98. ================
  99. I looked at several file comparison programs, but none addressed my 
  100. specific requirements so I wrote my own.
  101.  
  102. jDif is faster than the other programs I looked at, and accurate.
  103.  
  104. I used the algorithm of E. W. Myers, An O(ND) Difference Algorithm 
  105. and Its Variations, Algorithmica (1986) 1: 251-266.
  106.  
  107.